home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / fcv095.zip / FASTCHAT.DOC next >
Text File  |  1990-05-13  |  49KB  |  1,145 lines

  1.  
  2.  
  3.  
  4.                                    FastChat
  5.                       Full-Screen Chatting at its finest
  6.  
  7.                          For RemoteAccess BBS Systems
  8.                                By: Peter Hebert
  9.                                    1:135/57
  10.  
  11.          Preface
  12.          -------
  13.  
  14.          Welcome to the world of FastChat.  I'm glad you took the time
  15.          to  download/FREQ  this,  and  sincerely hope that  you  will
  16.          continue to use it.
  17.  
  18.          Keep  in  mind that it  comes with no guarantees  whatsoever.
  19.          I'm not responsible for any damages,   loss of profits,  etc.
  20.          caused by  your  use  of  this software.    I'm sure y'all've
  21.          heard  this before,  so need I say more?   Gets kinda  boring
  22.          after the fiftieth time...
  23.  
  24.          FastChat  is  shareware.   Do not sell it or bundle  it  with
  25.          anything without express permission from me. If this piece of
  26.          software (or any other, for that matter)  becomes a permanent
  27.          part of your menu structure, you are expected to register it.
  28.          A registration form is at the end of this document.
  29.  
  30.          Registration entitles you to a "key" (a coded number)  which,
  31.          once  inserted into FCConfig,  causes it to say  "(Registered
  32.          to: <your name>" whenever FastChat exits.  FastChat is not in
  33.          anyway  CrippleWare (how I dread the word)  and  registration
  34.          does not "unlock" any special features.
  35.  
  36.          As  far as technical support is concerned,   I love to answer
  37.          netmail and E-mail, though sometimes I'm a little slow.    So
  38.          in any correspondence, try to be as specific as possible  and
  39.          I'll get back to you as soon as I can.   Netmail is preferred
  40.          over SnailMail (without question!)
  41.  
  42.          "All  trademarks  and registered trademarks belong  to  their
  43.          respective owners."
  44.  
  45.          Now onto the good stuff...
  46.  
  47.  
  48.  
  49.            FastChat 0.95 - Full screen chatting for RemoteAccess
  50.            -----------------------------------------------------
  51.  
  52.          Introduction
  53.          ------------
  54.  
  55.          FastChat is sysop to user chatting at its finest - I designed
  56.          FastChat  to  be extremely versatile and powerful.   FastChat
  57.          represents  several  months  of  development  time  and  beta
  58.          testing  on my part and others'.   Designed for RemoteAccess,
  59.          FastChat  uses  many  RA-specific  features  (thus   is   not
  60.          guaranteed to run with any other BBS software.)
  61.  
  62.          Here  is a partial features list that separates FastChat from
  63.          other similar-but-different full screen chatting programs:
  64.  
  65.            *  Configurable ANSI colors for the windows and text
  66.            *  Full screen configuration program with windows and
  67.               moving bar menus and the such
  68.            *  Disable-able onscreen clock at the bottom of the screen
  69.            *  Works through the FOSSIL driver
  70.            *  Ties in with the [Wants Chat] flag - always know when
  71.               your users are paging you
  72.            *  Ties in with RA's Alt-O function for paging overrides
  73.            *  Hours configurable for each day of the week
  74.            *  "Forced chat" function for use on an Alt-F? key
  75.            *  Color in ASCII mode on the sysop's side
  76.            *  Much much more ...
  77.  
  78.          Using  FastChat   is   just   as easy as using RemoteAccess's
  79.          internal chat mode, and without sacrifice of features.  There
  80.          are  even  features  that  can   be used if you enjoy playing
  81.          around  with  your users (which I do a lot),  like to disable
  82.          their  input  and  to  jump  into  their  window  to  type...
  83.          There is something for everyone.
  84.  
  85.          Installation
  86.          ------------
  87.  
  88.          Installation  couldn't  be   easier.   Here's  a step by step
  89.          guide to installation for those who need it:
  90.  
  91.          1) UnZip FastChat into any directory which you please.
  92.  
  93.          2) If not the \RA directory, copy FASTCHAT.EXE, FASTCHAT.HLP,
  94.             and FCCONFIG.EXE into the \RA directory.  For good measure
  95.             you may want to bring PAGERAC.EXE over, as well.
  96.  
  97.          3) Replace your chatting option on the main menu (or wantchat
  98.             menu if you have one) with a type 7, optional data =
  99.  
  100.          "\RA\FASTCHAT.EXE \RA\DORINFO1.DEF*!".
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                    Page 2
  107.  
  108.  
  109.  
  110.            FastChat 0.95 - Full screen chatting for RemoteAccess
  111.            -----------------------------------------------------
  112.  
  113.          4)  In  RaConfig,  set  one  of  your  free  Alt-Fx   keys to
  114.          "\RA\FASTCHAT.EXE !\RA\DORINFO1.DEF*!".   This will allow you
  115.          to  force   a  FastChat by pressing Alt-Fx  (makes much  more
  116.          sense then installing a hidden key on each of your menus!)
  117.  
  118.          5)  Run  FCCONFIG,  and  read  the  next  section  of    this
  119.          document...(appropriately titled "Configuration")
  120.  
  121.          Configuration
  122.          -------------
  123.  
  124.          Configuration  is easy and will not take very much time.   In
  125.          your  base  system  directory  (called  \RA  throughout  this
  126.          document), run FCCONFIG.  It will report that a configuration
  127.          file is not found and will ask you if you wish to create one.
  128.  
  129.          Respond "Y" for Yes.  FCConfig will briefly read in Config.Ra
  130.          to get some information,  then you will be presented with the
  131.          main menu.
  132.  
  133.          The  main  menu   has   eight   options:   Colors,  Defaults,
  134.          Options, Directories,  Paging hours,  Registration,  Save and
  135.          quit,  and  Quit   without   save.     All   eight   will  be
  136.          discussed in depth shortly.
  137.  
  138.          To maneuver about FCConfig, follow these guidelines:
  139.  
  140.          Use Up, Down, Home, and End to move the highlight bar.  Press
  141.          Enter  to select or to change an item.   Pressing Escape will
  142.          exit  the  current  function - if inputting something it will
  143.          abort,   if  at a submenu it will go back  and if at the main
  144.          menu it will save your changes and exit FCConfig.
  145.  
  146.          Configuration / Colors
  147.          ----------------------
  148.  
  149.          Upon  selection  "Colors" off the main menu,  the screen will
  150.          clear  and a sample full screen FastChat session will appear.
  151.          In  the  two  windows  will appear instructions which briefly
  152.          summarize what is here.
  153.  
  154.          The  top  row  number  keys  cycle through the colors for the
  155.          various parts of the screen.   When colors cycle,  they go in
  156.          the following order:
  157.  
  158.                   Black               (*) Dark Gray
  159.                   Blue                (*) Light Blue
  160.                   Green               (*) Light Green
  161.                   Cyan                (*) Light Cyan
  162.                   Red                 (*) Light Red
  163.                   Magenta             (*) Light Magenta
  164.                   Amber               (*) Yellow
  165.                   Gray                (*) White
  166.  
  167.                                    Page 3
  168.  
  169.  
  170.  
  171.            FastChat 0.95 - Full screen chatting for RemoteAccess
  172.            -----------------------------------------------------
  173.  
  174.          Colors marked with an asterisk (*) do not apply to background
  175.          colors.
  176.  
  177.          Background  colors look somewhat tacky on the chatting screen
  178.          and   it   is   not   recommended   that  you  use  them  for
  179.          aesthetic reasons.
  180.  
  181.          The keys for cycling through colors are...
  182.  
  183.          <1> User border foreground
  184.          <2> User border background
  185.          <3> Text color foreground
  186.          <5> Sysop border foreground
  187.          <6> Sysop border background
  188.          <7> Status line lolite foreground
  189.          <8> Status line lolite background
  190.          <9> Status line hilite foreground
  191.          <0> Status line hilite background
  192.  
  193.          In addition there are other available keys:
  194.  
  195.          <Space> Reset the colors (undo)
  196.          <Enter> Accept these colors
  197.          <Escape> Abort and return to main menu
  198.          <Tab> Jump over to the ASCII-Chat colors menu
  199.  
  200.          Their function is fairly obvious, however the <Tab>  function
  201.          will be elaborated on.   Pressing <Tab>  will pop up a window
  202.          with  a  sample  of ASCII-Chat colors (for  non-ansi  users).
  203.          ASCII colors only appear locally.  To cycle them:
  204.  
  205.          <1> Sysop text color
  206.          <2> User text color
  207.  
  208.          All  additional keys except <Tab>  are active as  well.   The
  209.          status  line  in  ASCII mode uses the same color set  as  the
  210.          status line in split-screen mode.
  211.  
  212.          Configuration / Defaults
  213.          ------------------------
  214.  
  215.          The "Defaults" menu is where you set the various defaults for
  216.          the   Ctrl-key  functions  available  while  chatting.    All
  217.          defaults  are "Yes/No"  type options and usually control what
  218.          the user can and cannot do.
  219.  
  220.          ---------- Capture on (default: No)
  221.          This  controls whether the capture file (the file which keeps
  222.          a record of everything typed by both parties) is enabled upon
  223.          entry  of  FastChat.   This  is toggled while  chatting  with
  224.          Ctrl-A.
  225.  
  226.  
  227.  
  228.                                    Page 4
  229.  
  230.  
  231.  
  232.            FastChat 0.95 - Full screen chatting for RemoteAccess
  233.            -----------------------------------------------------
  234.  
  235.          ---------- Remote keyboard enabled (default: Yes)
  236.          This controls whether or not the user's input is acknowledged
  237.          upon entry.  I don't know why in particular you would want to
  238.          set  this  to  No,  however you can if you would  like  (feel
  239.          free!).  This is toggled while chatting with a Ctrl-K.
  240.  
  241.          ---------- Owner only backspacing (default: Yes)
  242.          This  controls whether or not the user can backspace what the
  243.          sysop  types.   This is kind of useless but can be useful  to
  244.          toggle  when  you are chatting with that obnoxious  user  who
  245.          always  butts in while you're typing .  .  .  (toggled  while
  246.          chatting  with  Ctrl-O).   This option is ONLY  available  in
  247.          ASCII mode.
  248.  
  249.          ---------- Double spacing (default: Yes)
  250.          This  controls  whether double spacing is active  on  default
  251.          when FastChat starts.   Double spacing means that when either
  252.          party  presses Enter,  it automatically jumps down two  lines
  253.          instead  of one.   This is rather useful since often that  is
  254.          how  you separate 'paragraphs'  when chatting.   However,  it
  255.          does  take a little getting used to...(toggled while chatting
  256.          with  Ctrl-D).   This option is available in ASCII mode only,
  257.          as well.
  258.  
  259.          ---------- User can TERMINATE chat (default: Yes)
  260.          This controls (doesn't that phrase get to you after a while?)
  261.          whether  or not the user can terminate the chat from  his/her
  262.          side.  If enabled,  the user can type "terminate"  on a blank
  263.          line  and  when they press Enter the chat will end.   If  you
  264.          don't  want the user getting out then set this to No or press
  265.          Ctrl-T while chatting.
  266.  
  267.          ---------- Start off in user's window (default: No)
  268.          I  really have no earthly idea why you would want to START in
  269.          the  user's  window,  however  it is here if you'd  like  to.
  270.          While  chatting,  you can jump between windows with a Ctrl-C.
  271.          This,  combined with Ctrl-K (remote keyboard disable)  can be
  272.          used to put words in a user's mouth (which is very amusing)
  273.  
  274.          ---------- High character filter (default: No)
  275.          This controls the high character filter.  In other words,  it
  276.          controls whether or not high characters (the "upper 128", box
  277.          characters,  etc)  will  be displayed when received from  the
  278.          user.   They  are  always  permitted to be entered  from  the
  279.          sysop's  side.   This can also act as a line noise filter  of
  280.          sorts,  as  most  line noise is in the "upper  128".   Toggle
  281.          while chatting with a Ctrl-F.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.                                    Page 5
  290.  
  291.  
  292.  
  293.            FastChat 0.95 - Full screen chatting for RemoteAccess
  294.            -----------------------------------------------------
  295.  
  296.          ---------- User control keys (default: Yes)
  297.          Simply  controls whether Ctrl-W and Ctrl-R work for the  user
  298.          (these  and all the other control keys are explained  later).
  299.          Toggle while chatting with a Ctrl-O, though the need for this
  300.          is  uncommon.    Usually  used  if  there  is  a  really  bad
  301.          connection and ctrl-keys are coming down the line too...
  302.  
  303.          That's all for the "Defaults" menu.   Don't fret it about all
  304.          the  control keys briefed here,  these and more will be fully
  305.          described later in the document.
  306.  
  307.          Configuration / Options
  308.          -----------------------
  309.  
  310.          The options menu is similar to the Defaults menu in that most
  311.          of  the  options  are "Yes/No".   However it differs  in  the
  312.          respect  that  there  are no Ctrl-keys  for  these  functions
  313.          because  these  functions control more the way FastChat  acts
  314.          rather than how the user acts.  For example...
  315.  
  316.          ---------- FastChat operates in silence (default: No)
  317.          Controls  whether  fastchat  stays  silent at  ALL  times  or
  318.          whether  it  makes noise.   This silence is  universal,  with
  319.          effects  reaching everywhere in the program,  from the paging
  320.          bell all the way to the Ctrl-key bleeps.
  321.  
  322.          ---------- Carrier loss detection (default: Yes)
  323.          Setting  this  to No will cause FastChat NOT to exit  if  and
  324.          when  a  user drops carrier.   If you have your own means  of
  325.          handling  this,  then set this to No,  otherwise let FastChat
  326.          worry about it and do all necessary housecleaning when a user
  327.          dumps you.
  328.  
  329.          ---------- Watch user's online time (default: No)
  330.          If  you find that you often chat wwaaayyy too  long,  setting
  331.          this  to  Yes  will cause FastChat to exit when the  user  is
  332.          nearing the end of their time.  This is rather useless if you
  333.          are using the *! option with RemoteAccess,  however if you're
  334.          a stickler about time, set this to Yes.
  335.  
  336.          ---------- Use CTS/RTS handshaking (default: No)
  337.          CTS/RTS  handshaking is used normally with high speed  modems
  338.          in  conjunction with a locked port.   If your port is  locked
  339.          and  you have an intelligent FOSSIL driver,  the port will by
  340.          default  use CTS/RTS handshaking.   Setting this to Yes  will
  341.          cause  FastChat to turn it on.   Usually unnecessary  however
  342.          still good measure if you use a high speed modem.
  343.  
  344.          ---------- Clock on the bottom line (default: Yes)
  345.          Normally when in split screen (ANSI)  mode,  there is a clock
  346.          on  the  bottom line of the sysop's window.   If your  system
  347.          clock  is never set or you find the clock annoying,  you  can
  348.          turn it off with this option.
  349.  
  350.                                    Page 6
  351.  
  352.  
  353.  
  354.            FastChat 0.95 - Full screen chatting for RemoteAccess
  355.            -----------------------------------------------------
  356.  
  357.          ---------- Sysop is Male (default: Yes)
  358.          No,  I'm  not  sexist....<grin>   In some of the default  (no
  359.          .ASC/.ANS  screen)  messages,  FastChat  uses a third  person
  360.          pronoun  (He  or She)...Setting this to Yes will cause it  to
  361.          use "he", setting it to no will cause it to use "she".
  362.  
  363.          ---------- Maximum number of pages per call (default: ?)
  364.          This  determines  how  many times the user can  page  in  one
  365.          session.  The default is determined by reading CONFIG.RA upon
  366.          creation  of the FastChat configuration file.   If you really
  367.          don't care then set this to some high number like 99 or so...
  368.  
  369.          ---------- Page bell options (defaults: Over the Hill, 10)
  370.          Selecting  this option will pop up yet another submenu  which
  371.          controls  aspects  about the paging bell (like which  one  to
  372.          use,  and how long to ring it).   These options are described
  373.          below:
  374.  
  375.          -------------------- Page bell type
  376.          Selecting  this  pops up a little menu from which you  select
  377.          your paging bell type.  There are six to choose from:
  378.  
  379.          Over the hill - Five notes up and five notes down.  Simple.
  380.          Staircase     - Similar to Over the hill, but ten notes up.
  381.          Random sounds - Technojunk.  Random tones.
  382.          Telephone     - Like a cheap telephone ringing.
  383.          English Cop   - Similar to an English cop car's siren
  384.          External      - Use the PAGE.RA/FASTPAGE.FC file
  385.  
  386.          You HAVE to pick one - the escape key is not active  in  this
  387.          menu.   Selecting one of the top five will cause it to play a
  388.          quick little demo (one "iteration" of that sound).  Selecting
  389.          External  will cause FastChat to use the  PAGE.RA/FASTPAGE.FC
  390.          combo (more on this later).
  391.  
  392.          -------------------- Page bell length
  393.          This  allows  you  to enter the length of the  page  bell  in
  394.          seconds.   FastChat plays the same jingle over and over until
  395.          it gets near the point of the value you specify here.
  396.  
  397.          ---------- End of window action (default: Wrap)
  398.          Selecting  this will bring up a popup menu with three choices
  399.          for end-of-window actions.  In plain English, this determines
  400.          what  happens  when your chat reaches the end of the  window.
  401.          This  feature was really the whole reason I wrote FastChat in
  402.          the  first  place -  the chat program I  *WAS*  using  always
  403.          cleared  at the end of window and it drove me crazy....thus I
  404.          wrote  FastChat!   (ok  so it may be trivial but  interesting
  405.          nonetheless)
  406.  
  407.  
  408.  
  409.  
  410.  
  411.                                    Page 7
  412.  
  413.  
  414.  
  415.            FastChat 0.95 - Full screen chatting for RemoteAccess
  416.            -----------------------------------------------------
  417.  
  418.          You have three choices:
  419.  
  420.          Wrap around  - Jumps up to the top of the window again.  Text
  421.                         remains  on  the  other lines of  the  window.
  422.                         Like unix 'xtalk' if you've ever used it.
  423.  
  424.          Clear window - Yes, the dreaded clear window option.   Clears
  425.                         the window once you reach the bottom.
  426.  
  427.          Scroll       - This one's a little tricky.  When selected, it
  428.                         asks  you how many lines to scroll  by.   What
  429.                         happens  is that once you reach the end of the
  430.                         window, it scrolls up all the remaining text X
  431.                         number of lines.   X is a hard number to find,
  432.                         setting  it  too high makes the chat  hard  to
  433.                         follow,  too  low  makes it too  slow  because
  434.                         scrolling       is      not       particularly
  435.                         speedy....(particularly at 1200 baud!)
  436.  
  437.          And  that's the end of the Options menu.   It's all real easy
  438.          from here.
  439.  
  440.          Configuration / Directories
  441.          ---------------------------
  442.  
  443.          Here  you  specify the various directories and filenames  for
  444.          various files.  The six things you should specify are...
  445.  
  446.          ---------- RA System directory
  447.          This   is  the  directory  that  PAGESTAT.RA  is  sought  in.
  448.          Defaults to the system directory specified in RaConfig.
  449.  
  450.          ---------- RA TxtFiles directory
  451.          This  is  the directory in which all .ASC and .ANS files  are
  452.          held.  FastChat will display certain .ASC and .ANS files when
  453.          certain  conditions  are met (sysop did  not  answer,  etc..)
  454.          These files will be explained later.
  455.  
  456.          ---------- EXITINFO.BBS directory
  457.          This  is  the  directory which holds the  door/bbs  interface
  458.          file, EXITINFO.BBS.  This is the most important file, because
  459.          without  it the [Wants Chat]  flag is not updated nor is  the
  460.          "number  of pages this call"  counter.   FastChat will  chirp
  461.          when run if this file cannot be found.
  462.  
  463.          ---------- Capture filename
  464.          This  is  the  full path and filename for the  capture  file.
  465.          This  is  the log of all things typed that is opened  with  a
  466.          Ctrl-A  while  chatting.   Specify a full path  and  filename
  467.          here.
  468.  
  469.  
  470.  
  471.  
  472.                                    Page 8
  473.  
  474.  
  475.  
  476.            FastChat 0.95 - Full screen chatting for RemoteAccess
  477.            -----------------------------------------------------
  478.  
  479.          ---------- Reason Ques. filename (optional)
  480.          The reason to chat questionnaire is an optional feature which
  481.          FastChat  supports.   If on your system you have a .Q-A  file
  482.          which  is  executed before chat program,  put the name  here.
  483.          FastChat  will attempt to read the .ASW file and extract  the
  484.          reason to chat.   This reason will be displayed in a box when
  485.          paging  and  in  the log afterward.   If you do not  wish  to
  486.          support this, leave this field blank.
  487.  
  488.          ---------- Log filename (optional)
  489.          FastChat  will keep a record of all actions and reasons in an
  490.          optional log file.   If you wish a log file to be kept,  fill
  491.          in this field with a full path and filename.  The log file is
  492.          formatted much like a FrontDoor style log.
  493.  
  494.          And   that   concludes   the  Directories  section   of   the
  495.          configuration, only two little submenus left..
  496.  
  497.          Configuration / Paging hours
  498.          ----------------------------
  499.  
  500.          When  it  comes  to  paging  hours,   FastChat  is  extremely
  501.          flexible.   The  paging  hours  menu has one  Yes/No  option:
  502.          "Ignore   paging   hours",   which  disables   paging   hours
  503.          altogether.  The remaining seven options are for setting each
  504.          day of the week's valid paging hours.
  505.  
  506.          When  you select one,  a little box will appear prompting you
  507.          for the start time.  In this box you may enter the start time
  508.          in any of the following formats:
  509.  
  510.          hh:mm (ex: 23:45 for 11:45 PM)
  511.          hh:mmXX (ex: 11:23 PM)
  512.          hhXX (ex: 1 PM for 1:00 PM)
  513.          midnight (for 12:00 AM)
  514.          noon (for 12:00 PM)
  515.          X (if paging is not allowed on this day of the week)
  516.  
  517.          The "time-parser"  is very flexible and will try to translate
  518.          anything you throw at it.  Note that "X"  (for "Not Allowed")
  519.          is only permitted in the "start time" box.
  520.  
  521.          Do  the same for the end time,  and then for all the days  of
  522.          the  week.   By default,  each day's time will be set to  the
  523.          appropriate time specified in RAConfig.
  524.  
  525.          Configuration / Registration
  526.          ----------------------------
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                                    Page 9
  534.  
  535.  
  536.  
  537.            FastChat 0.95 - Full screen chatting for RemoteAccess
  538.            -----------------------------------------------------
  539.  
  540.          Like  I  said in the beginning,  FastChat is  shareware.   In
  541.          order  to  know  whether you have a registered copy  or  not,
  542.          there  is  a "slot"  here for a  registration  number.   This
  543.          number is unique (in theory) to your name, and provided by me
  544.          upon your registration.
  545.  
  546.          There are only two options on this menu:
  547.  
  548.          ---------- Registered name
  549.          This  is  your name as you would like it shown to the  users.
  550.          Hopefully  you provided me with the same name so that I could
  551.          whip you up a valid key number <grin>.   The default is taken
  552.          from CONFIG.RA.
  553.  
  554.          ---------- Registered number
  555.          This  is  the number which I provide you  upon  registration.
  556.          It's  usually in the range of about 5,000 to 30,000 depending
  557.          on how long your name is and what its letters are.
  558.  
  559.          And  that basically concludes Configuration.   The  remaining
  560.          two   options  on  the  configuration  main  menu  are   self
  561.          explanatory  -  Save and exit,  and Quit without  save.   You
  562.          ought to be able to figure out what these do...
  563.  
  564.          Onto the next section...
  565.  
  566.          ASC/ANS screens
  567.          ---------------
  568.  
  569.          The  rest of the setup is minimal.   If you do not have  them
  570.          installed already with RA, unzip SAMPSCRN.ZIP (it ought to be
  571.          included  in  the  distribution archive)  into  the  TxtFiles
  572.          directory.   This  is for the custom ASC/ANS files on certain
  573.          paging conditions.
  574.  
  575.          These files are not required, as FastChat has its own default
  576.          messages  that  will be displayed if a corresponding  ASC/ANS
  577.          file is not found.  Valid filenames are:
  578.  
  579.          NOTAVAIL.A?? - Displayed  if  user  paged  during  non-paging
  580.                         hours.   This  one is also used internally  in
  581.                         RemoteAccess.
  582.          MAXPAGE.A??  - Displayed  if  the user pages too  many  times
  583.                         (beyond   the  number  of  time  specified  in
  584.                         FCConfig)  This one too is in RemoteAccess.
  585.          SYSPABRT.A?? - Displayed if the sysop aborts the page.  (same
  586.                         filename in RemoteAccess)
  587.          PAGED.A??    - Displayed  if  the  page times  out.   Use  to
  588.                         inform  the  user  that  you  are  not  around
  589.                         however lights are flashing and if you walk by
  590.                         you   will  break  in.    (same  filename   in
  591.                         RemoteAccess)
  592.  
  593.  
  594.                                   Page 10
  595.  
  596.  
  597.  
  598.            FastChat 0.95 - Full screen chatting for RemoteAccess
  599.            -----------------------------------------------------
  600.  
  601.          ALREADY.A??  - Displayed  if the user already has WantChat on
  602.                         (they  have  already  paged w/o  a  response).
  603.                         This one is not in RA...
  604.  
  605.          Again,  these  all have default messages if you choose not to
  606.          implement them.  The sample ones provided have the 'style' of
  607.          my  BBS,  so  you may want to change them to suit your  BBS's
  608.          style....
  609.  
  610.          External paging bell
  611.          --------------------
  612.  
  613.          FastChat fully supports the external paging bell available in
  614.          RA  0.03.   As a matter of fact,  it expands slightly on  the
  615.          PAGE.RA  language.   One caveat though -  the PAGE.RA file is
  616.          COMPILED  into  a file called FASTPAGE.FC by a  utility  that
  617.          should be in this distribution archive, PageRaC.
  618.  
  619.          Why  compile?   No,  it's not to take up an extra cluster  on
  620.          your hard disk.  It reduces the size of FASTCHAT.EXE somewhat
  621.          and  also makes for faster loading.   However,  you need  not
  622.          concern  yourself with that,  only concern yourself with  the
  623.          fact that you MUST compile.
  624.  
  625.          Syntax:
  626.               PageRaC [filename]
  627.  
  628.          If [filename] is not specified, then it defaults to PAGE.RA.
  629.  
  630.          The commands available in the song file are:
  631.  
  632.          ---------- TONE [freq] [dur]
  633.          This  sounds  a tone (whose frequency is  [freq])  for  [dur]
  634.          units.  "Units"  is centiseconds or milliseconds depending on
  635.          how  you  have  it  set (it  defaults  to  centiseconds,  for
  636.          compatibility with RA).  The list of frequencies can be found
  637.          in  the PAGE.RA that came with RemoteAccess as well as in the
  638.          RemoteAccess documentation.
  639.  
  640.          ---------- WAIT [dur]
  641.          This causes a period of silence [dur] units long.
  642.  
  643.          -------{*} REPEAT [times] .... END loop
  644.          This is an extended PageRaC command.  It allows you to repeat
  645.          stanzas  more  than once in a row more concisely than  simply
  646.          repeating it physically in the file.   This and all the other
  647.          extended commands (marked with a {*}) can be preceded with ;-
  648.          so that RA will think they are a comment.
  649.  
  650.          Confusing?  Perhaps.  An example may clear things up:
  651.  
  652.  
  653.  
  654.  
  655.                                   Page 11
  656.  
  657.  
  658.  
  659.            FastChat 0.95 - Full screen chatting for RemoteAccess
  660.            -----------------------------------------------------
  661.  
  662.          ;-REPEAT 2
  663.          TONE 200 40
  664.          TONE 400 40
  665.          TONE 600 40
  666.          TONE 800 40
  667.          WAIT 20
  668.          ;-END
  669.  
  670.          That  would  play  those four notes  twice.   Notice  the  ;-
  671.          prefixing  the  REPEAT  and END  commands.   This  is  purely
  672.          OPTIONAL.
  673.  
  674.          -------{*} MS
  675.          This   makes  the  duration  of  TONE  and  WAIT   statements
  676.          milliseconds rather than centiseconds.
  677.  
  678.          -------{*} CS
  679.          This   makes  the  duration  of  TONE  and  WAIT   statements
  680.          centiseconds (the default) rather than centiseconds.
  681.  
  682.          That's  all for the external page bell.   One last note:  You
  683.          only need to run PageRaC once, unless you change your PAGE.RA
  684.          file.  It's the type of thing you will do then forget about.
  685.  
  686.          Invocation
  687.          ----------
  688.  
  689.          You  may  have  noticed in the Installation  section  that  I
  690.          specifically gave you a set of command line parameters.  This
  691.          is  probably what you would want to use.   However,  FastChat
  692.          accepts  other parameters,  as well.   Here is a list of  all
  693.          valid command line types:  (parameters are case insensitive)
  694.  
  695.          ---------- FastChat /Local
  696.          This  activates  a  local test mode.   No  ExitInfo  file  is
  697.          needed,  no  user  need be online.   Everything you  type  is
  698.          echoed  into the user's window.   (the absence of an ExitInfo
  699.          file will cause a chirp, however)
  700.  
  701.          ---------- FastChat /Version
  702.          This  causes FastChat to display its version number and exit.
  703.          This  also displays registration information (telling you  if
  704.          the  copy is registered or not).   Run this after  installing
  705.          your registration number in FCConfig.
  706.  
  707.          ---------- FastChat [!]p:[h]b(t,g) "user"
  708.          This  is the "command-line"  format of starting up  FastChat.
  709.          You  wouldn't  usually  need  to  use  this.   As  a  type  7
  710.          parameter, it would look like this:
  711.  
  712.               d:\ra\fastchat.exe *p:*b(*t,*g) "*f *l"
  713.  
  714.  
  715.  
  716.                                   Page 12
  717.  
  718.  
  719.  
  720.            FastChat 0.95 - Full screen chatting for RemoteAccess
  721.            -----------------------------------------------------
  722.  
  723.          Use - When you are being paged
  724.          ------------------------------
  725.  
  726.          This  is  basically what the screen looks like  when  someone
  727.          pages you:
  728.  
  729.                           FastChat - Version 0.95
  730.                   Copyright 1990 Peter Hebert - 1:135/57
  731.  
  732.      +----------------------------------------------------------------+
  733.      | This is a sample user reason.  This can be up to five lines of |
  734.      | sixty-five characters each.                                    |
  735.      +----------------------------------------------------------------+
  736.  
  737. Typical User is paging you...
  738. Press <C> to Chat or <A> to Abort the page...
  739.  
  740. Paging the SysOp, please wait...
  741.  
  742.          The  top two lines are the intro and copyright stuff.   These
  743.          will  always appear,  whether you initiate a page or  whether
  744.          the user does.
  745.  
  746.          The  reason will appear only if you have put something in the
  747.          "Reason to chat Ques."  field in FCConfig,  and have executed
  748.          the questionnaire prior to running FastChat.  The reason will
  749.          also  go in the log if you have it enabled,  and the original
  750.          .ASW will be deleted.
  751.  
  752.          Then you see the user's name, and a little prompt.  Just like
  753.          it says: press <C> if you want to start chatting,  or <A>  if
  754.          you want to abort.  Simple, eh?
  755.  
  756.          The  user  can  also  abort the page by  pressing  Ctrl-C  or
  757.          Ctrl-K.
  758.  
  759.          More  dots  will appear after the "Paging the  SysOp,  please
  760.          wait..."  line,  about  one every second.  It is during  this
  761.          time in which you are allowed to answer the page.
  762.  
  763.          It's  really quite simple.   Colors will appear in both  ANSI
  764.          and ASCII mode,  however in ASCII mode colors are not visible
  765.          to the user.
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.                                   Page 13
  778.  
  779.  
  780.  
  781.            FastChat 0.95 - Full screen chatting for RemoteAccess
  782.            -----------------------------------------------------
  783.  
  784.          Use - Split-Screen chatting mode
  785.          --------------------------------
  786.  
  787.          This  is  perhaps the most complex section of  the  document.
  788.          The split screen mode is very powerful and complex,  and will
  789.          probably take a little getting used to.  However once you use
  790.          it for a little while you will undoubtedly become "hooked".
  791.  
  792.          Once  you answer the page,  and the user is in ANSI  mode,  a
  793.          screen  similar  to  the "Colors"  screen  in  FCConfig  will
  794.          appear.
  795.  
  796.          Now....CHAT!   You  may  both  type at  the  same  time,  and
  797.          wordwrap  is active.   You may wish to double-space,  however
  798.          whether  you  do  or not is a matter of  personal  style  and
  799.          taste.
  800.  
  801.          A few things to keep in mind:  When you both type at the same
  802.          time,  things  may get a little chunky (particularly at lower
  803.          baud rates).  Don't worry about this, it's normal.
  804.  
  805.          Also,  if  you have End of window Scrolling enabled,  you CAN
  806.          type  while it is scrolling.   No need to wait for it to stop
  807.          scrolling before you can continue.
  808.  
  809.          The user has two keys at his/her disposal:
  810.  
  811.          Ctrl-W - Clear window
  812.          Ctrl-R - Redraw screen (in case of line noise, etc)
  813.  
  814.          Also  the  enter,  backspace,  and tab keys work as would  be
  815.          expected.
  816.  
  817.          As sysop, you have several keys at your disposal:
  818.  
  819.          Ctrl-A  - Toggle capture file
  820.          Ctrl-C  - Jump between windows
  821.          Ctrl-F  - Toggle high character filter
  822.          Ctrl-G  - Beep the user
  823.          Ctrl-K  - Toggle remote keyboard
  824.          Ctrl-O  - Toggle user's ability to use Ctrl-W/R
  825.          Ctrl-Q  - Clear the USER'S window
  826.          Ctrl-R  - Redraw the screen
  827.          Ctrl-S  - Shell to DOS
  828.          Ctrl-T  - Toggle user's ability to 'TERMINATE' the chat
  829.          Ctrl-W  - Clear your window
  830.          Esc-Esc - Terminate chat
  831.  
  832.          Each of the "toggle"  Ctrl-keys produce a sound when pressed:
  833.          If the notes go up,  that option was just turned on.   If the
  834.          notes go down, then the option is being turned off.
  835.  
  836.  
  837.  
  838.                                   Page 14
  839.  
  840.  
  841.  
  842.            FastChat 0.95 - Full screen chatting for RemoteAccess
  843.            -----------------------------------------------------
  844.  
  845.          Now for the explanation of all these keys:
  846.  
  847.          ---------- Ctrl-A: Toggle capture file
  848.          This simply toggles the capture file on and off.  The capture
  849.          file (if you recall)  is the file in which everything that is
  850.          typed is recorded.
  851.  
  852.          ---------- Ctrl-C: Jump between windows
  853.          (the C stands for "C"hange,  by the way).  Pressing this will
  854.          send  you  into the other window.   Everything you type  will
  855.          then appear in that window.   Used in conjunction with Ctrl-K
  856.          this is a blast....
  857.  
  858.          ---------- Ctrl-F: Toggle high character filter
  859.          The   high   character  filter   disallows/allows   upper-128
  860.          characters.   These are the box characters and ALSO (usually)
  861.          the  line noise characters.   Turning the filter on can often
  862.          aide  chatting  over a noisy connection (but of  course,  the
  863.          best solution is to have an MNP modem on both ends).
  864.  
  865.          ---------- Ctrl-G: Beep user
  866.          I  have  absolutely NO idea what the G stands  for,  ask  the
  867.          people  who invented ASCII.   Pressing Ctrl-G sends a beep to
  868.          the remote side.  Use this to wake up that sleeping user.....
  869.  
  870.          ---------- Ctrl-K: Toggle remote keyboard
  871.          This  is  definitely  my  favorite key.   It  allows  you  to
  872.          disallow the user's typing.  This may be kind of moot,  after
  873.          all  the  purpose  of the program is to  aide  chatting,  not
  874.          hinder it, however it's nice for sticking words in the user's
  875.          mouth  (see  Ctrl-C)  or  if you  absolutely  MUST  interject
  876.          something  extremely important in the middle of what they are
  877.          saying.  Don't overuse (ticks people off...)
  878.  
  879.          ---------- Ctrl-O: Toggle user cOntrol (Ctrl-W/R)
  880.          This  allows  you  to disable/enable the user's  use  of  the
  881.          Ctrl-W and Ctrl-R keys.   On a particularly noisy line,  some
  882.          control characters may be coming through and this effectively
  883.          filters out those extraneous characters that wreck havoc with
  884.          the display.
  885.  
  886.          ---------- Ctrl-Q: Clear user's window
  887.          Admittedly "Q" is not very mnemonic, however it is right next
  888.          to "W" so that should give you a clue to its function.   It's
  889.          similar to the Ctrl-W function (which operates on your window
  890.          when you press it) however clears the user's window.  Simple.
  891.  
  892.          ---------- Ctrl-R: Redraw screen
  893.          This is exactly like the user's Ctrl-R, it redraws the screen
  894.          from  the  bottom up.   Use this if somehow your screen  gets
  895.          messed  up (like perhaps another screen bleeding through from
  896.          a  DESQview  process).   Note that it does affect the  remote
  897.          side too.
  898.  
  899.                                   Page 15
  900.  
  901.  
  902.  
  903.            FastChat 0.95 - Full screen chatting for RemoteAccess
  904.            -----------------------------------------------------
  905.  
  906.          ---------- Ctrl-S: Shell to DOS
  907.          This  clears  the  display and brings you to  a  DOS  prompt.
  908.          FastChat  remains  in memory (occupying  approximately  64k).
  909.          Type EXIT to return to chat mode.
  910.  
  911.          ---------- Ctrl-T: Toggle ability of user to terminate
  912.          Depending on your setup in FCConfig,  the user may or may not
  913.          be able to end a chat by typing 'terminate'  on a blank line.
  914.          Ctrl-T  allows you to do a quick switch between modes if  you
  915.          don't want to let someone out for some reason or another,  or
  916.          vice versa.
  917.  
  918.          ---------- Ctrl-W: Clear window
  919.          This  simply clears your window and returns the cursor to the
  920.          top.  The user has a function just like it (same key, too!)
  921.  
  922.          ---------- Esc-Esc: Terminate chat mode
  923.          To  end  your chatting session with the  user,  simply  press
  924.          Escape twice in succession.
  925.  
  926.          That  basically  describes  how to use the full  screen  chat
  927.          mode.   The  more  you use it the less you will have to  look
  928.          things up in this manual....it gets intuitive after a while.
  929.  
  930.          Use - Non-split screen mode
  931.          ---------------------------
  932.  
  933.          Non-split  screen mode (ASCII)  is pretty boring.   It's very
  934.          similar to RA's internal chat, with a few extra features.
  935.  
  936.          Locally,  the  sysop's text appears in yellow and the  user's
  937.          text  appears  in  dark cyan (like RA's  internal  ANSI  chat
  938.          mode).  The user does not see these colors.
  939.  
  940.          Also, The user has no control keys in this mode.   The SysOp,
  941.          however, has plenty:
  942.  
  943.          Ctrl-A  - Toggle capture file
  944.          Ctrl-D  - Toggle double spacing
  945.          Ctrl-F  - Toggle high character filter
  946.          Ctrl-G  - Beep the user
  947.          Ctrl-K  - Toggle remote keyboard
  948.          Ctrl-L  - Scroll the screen clear
  949.          Ctrl-O  - Toggle owner-only backspacing
  950.          Ctrl-S  - Shell to DOS
  951.          Ctrl-T  - Toggle user's ability to 'TERMINATE' the chat
  952.          Esc-Esc - Terminate chat
  953.  
  954.          Here are brief descriptions of their functions (mostly copied
  955.          verbatim from the ANSI chat mode section):
  956.  
  957.  
  958.  
  959.  
  960.                                   Page 16
  961.  
  962.  
  963.  
  964.            FastChat 0.95 - Full screen chatting for RemoteAccess
  965.            -----------------------------------------------------
  966.  
  967.          ---------- Ctrl-A: Toggle capture file
  968.          This simply toggles the capture file on and off.  The capture
  969.          file (if you recall)  is the file in which everything that is
  970.          typed is recorded.
  971.  
  972.          ---------- Ctrl-D: Toggle double spacing
  973.          This  turns automatic double spacing on or off.   When  auto-
  974.          double  spacing is on,  an Enter key from either party double
  975.          spaces, as is normal convention when chatting.   This takes a
  976.          little getting used to however you'll learn to love it...
  977.  
  978.          ---------- Ctrl-F: Toggle high character filter
  979.          The   high   character  filter   disallows/allows   upper-128
  980.          characters.   These are the box characters and ALSO (usually)
  981.          the  line noise characters.   Turning the filter on can often
  982.          aide  chatting  over a noisy connection (but of  course,  the
  983.          best solution is to have an MNP modem on both ends).
  984.  
  985.          ---------- Ctrl-G: Beep user
  986.          I  have  absolutely NO idea what the G stands  for,  ask  the
  987.          people  who invented ASCII.   Pressing Ctrl-G sends a beep to
  988.          the remote side.  Use this to wake up that sleeping user.....
  989.  
  990.          ---------- Ctrl-K: Toggle remote keyboard
  991.          This  is  definitely  my  favorite key.   It  allows  you  to
  992.          disallow the user's typing.  This may be kind of moot,  after
  993.          all  the  purpose  of the program is to  aide  chatting,  not
  994.          hinder it, however it's nice for sticking words in the user's
  995.          mouth.  Also useful if you absolutely MUST interject, without
  996.          getting the text all scrambled.   Don't overuse (ticks people
  997.          off...)
  998.  
  999.          ---------- Ctrl-L: Clear screen
  1000.          Pressing  this  clears the screen,  in a fashion  similar  to
  1001.          pressing Enter 24 times rapidly.
  1002.  
  1003.          ---------- Ctrl-O: Toggle owner-only backspacing
  1004.          This  toggles the user's ability to backspace what the  sysop
  1005.          types.   It  may seem a little useless however it works great
  1006.          for obnoxious users......
  1007.  
  1008.          ---------- Ctrl-S: Shell to DOS
  1009.          This  clears  the  display and brings you to  a  DOS  prompt.
  1010.          FastChat  remains in memory (occupying  approx.  64k).   Type
  1011.          EXIT to return to chat mode.
  1012.  
  1013.          ---------- Ctrl-T: Toggle ability of user to terminate
  1014.          Depending on your setup in FCConfig,  the user may or may not
  1015.          be able to end a chat by typing 'terminate'  on a blank line.
  1016.          Ctrl-T  allows you to do a quick switch between modes if  you
  1017.          don't want to let someone out for some reason or another,  or
  1018.          vice versa.
  1019.  
  1020.  
  1021.                                   Page 17
  1022.  
  1023.  
  1024.  
  1025.            FastChat 0.95 - Full screen chatting for RemoteAccess
  1026.            -----------------------------------------------------
  1027.  
  1028.          ---------- Esc-Esc: Terminate chat mode
  1029.          To  end  your chatting session with the  user,  simply  press
  1030.          Escape twice in succession.
  1031.  
  1032.          As you can see,  ASCII chat mode is simpler than split-screen
  1033.          mode.   There's  not much to it,  and due to the lack of ANSI
  1034.          function  codes  on  the  remote side,  not  very  much  that
  1035.          FastChat can do to expand it...
  1036.  
  1037.          Conclusion
  1038.          ----------
  1039.  
  1040.          I  certainly  hope this documentation is clear and  wish  you
  1041.          best of luck in getting FastChat up and running.
  1042.  
  1043.          I'd  like  to  thank the following beta  testers  (the  whole
  1044.          team!):
  1045.  
  1046.                              Arturo Batista
  1047.                              Tero Karkkainen
  1048.                              Mariano Sokal
  1049.                              Cindy Edens
  1050.  
  1051.          Without  them,  FastChat  would  never have been what  it  is
  1052.          today.
  1053.  
  1054.          Also,  if  you ever need to get in touch with me,  you can in
  1055.          the following ways:
  1056.  
  1057.          Netmail:
  1058.             Peter Hebert
  1059.             1:135/57
  1060.  
  1061.          BBS:
  1062.             The Software Cuisine, 1:135/57
  1063.             1-305-642-0754: Miami, FL, USA
  1064.             14.4k HST through 1200 baud
  1065.  
  1066.          SnailMail:
  1067.             Peter Hebert
  1068.             2352 SW 4th St.
  1069.             Miami, FL  33135-3134
  1070.  
  1071.          The  latest version of FastChat is always FREQable 22 hours a
  1072.          day under the magic name FASTCHAT from the following systems:
  1073.  
  1074.          Node#       Location                Maximum baud rate
  1075.          ----------- ----------------------- -----------------
  1076.          1:135/57    Miami, FL               14.4k HST
  1077.          1:135/79    Miami, FL               2400 plain
  1078.          4:900/109   Buenos Aires, Argentina 2400/MNP5
  1079.  
  1080.          Enjoy!  Sincerely - Peter Hebert, Author
  1081.  
  1082.                                   Page 18
  1083.  
  1084.  
  1085.  
  1086.                     Registration form for FastChat 0.95
  1087.                     -----------------------------------
  1088.  
  1089.          When registering, please fill out the following form and send
  1090.          it  SnailMail  with  the  appropriate  amount  (checks  only,
  1091.          please) enclosed:
  1092.  
  1093.          Peter Hebert
  1094.          FastChat Registration
  1095.          2352 SW 4th St.
  1096.          Miami, FL  33135-3134
  1097.  
  1098.          Please  make checks out to Peter Hebert.   Your  registration
  1099.          will  entitle  you to a key number,  which once  inserted  in
  1100.          FCConfig,    makes    your   copy   officially    registered.
  1101.          Registration  is  valid  for  all future  versions  of  plain
  1102.          vanilla FastChat.
  1103.  
  1104.          It is preferred that keys are sent NetMail however if it must
  1105.          be by SnailMail then so be it....(the key is simply a number,
  1106.          so there is no need for me to enclose a file or anything).
  1107.  
  1108.          Only  one registration is required per PHYSICAL BBS.   If you
  1109.          run  sixteen  lines,  then  you only need  one  registration,
  1110.          however if you run three different BBSs (ie, different names,
  1111.          different computers, etc), then you need three.  If you don't
  1112.          know what you need contact me and I'll figure it out.
  1113.  
  1114.          Note  that  just because your registration will WORK  on  all
  1115.          future versions, it is your responsibility to FIND all future
  1116.          versions,  as  for  $15  I certainly cannot send  you  a  new
  1117.          version everytime one comes out.
  1118.  
  1119.          Item                              Price  Qty.  Total
  1120.          ********************************* ****** ***** ************
  1121.  
  1122.          FastChat (all future versions     $15.00 _____ ____________
  1123.                    as well)
  1124.  
  1125.          ************************************************************
  1126.  
  1127.  
  1128.          Name       _____________________________ Node# _____________
  1129.  
  1130.          Address    _________________________________________________
  1131.  
  1132.                     _________________________________________________
  1133.  
  1134.                     _________________________________________________
  1135.  
  1136.          BBS name/# _________________________________________________
  1137.  
  1138.          Comments   _________________________________________________
  1139.  
  1140.                     _________________________________________________
  1141.  
  1142.  
  1143.                        Thank you for using FastChat!
  1144.  
  1145.